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INTRODUCTION 


Personal CP/M’s BDOS is a CP/M 2.2 compatible BDOS that has been 
enhanced to contain some of the functionality added to CP/M-PLUS. The 
BIOS organization of Personal CP/M is also very compatible with CP/M 2.2. 
The target size of the Personal CP/M BDOS module is 16 pages (4K Bytes), 
which is 2 pages (512 Bytes) larger than CP/M 2.2°s BDOS. 


MAJOR ADDITIONS 


The following items describe the major BDOS additions to Personal 
CP/M: 


1. AUTOMATIC DISK LOGIN 


The BDOS automatically relogs in a disk when it encounters a 
directory checksum error instead of marking the disk Read/Only. If the 
media change is detected after a file is opened on a drive, the BDOS 
returns an error on subsequent read and write operations for the file. 


2. WARM START PROCEDURE 


Personal CP/M, unlike CP/M 2.2, does not reset disk drives at warm 
start. However, in order to ensure accurate disk space computations in 
the BDOS and by transient programs such as STAT, the BIOS disk allocation 
vectors for Personal CP/M are twice as large as in CP/M 2.2. Each 
allocation vector consists of two CP/M 2.2 allocation vectors where the 
first vector records temporarily allocated blocks resulting from write 
operations and the second vector records permanently allocated blocks 
resulting from close operations. At drive login, both vectors are 
initialized to the same value. At warm start, the second vector is 
copied to the first vector. 

Note that the BDOS maintains a flag which the CCP can access after 
receiving control from the BIOS warm start routine to determine if the 
warm start occurred as the result of a “C typed at the system prompt. If 
this is the case, the CCP makes a disk reset call to reset the disk 
system. 


3. BLOCKING/DEBLOCKING 


The Personal BDOS does not perform record blocking/deblocking, but 
instead refers the task to the BIOS as in CP/M 2.2. The BIOS has three 
new functions: FLUSH, DISCARD, and MOVE. 

The BDOS calls the BIOS FLUSH function to signal the BIOS to write 
any write-pending blocking/deblocking buffers. The FLUSH function has no 
parameters but returns an error code to the BDOS in a like manner to the 
actions of the BIOS READ and WRITE functions. 


3. BLOCKING/DEBLOCKING (CONTINUED) 


The BDOS calls the DISCARD function to signal the BIOS to discard 
the contents of blocking/deblocking buffers. The DISCARD function has a 
parameter in register C which specifies a drive value. If the drive 
parameter matches the drive of an active blocking/deblocking buffer, the 
buffer must be discarded. If register C contains OFFH, all active 
buffers must be discarded unconditionally. The DISCARD function does not 
return an error code to the BDOS. 

The MOVE function is called to transfer data in memory. This 
function allows Z-80 systems to use the LDIR instruction to move data. 

To promote compatibility with existing CP/M 2.2 implementations, the 
BDOS references these new functions as EXTERNALS instead of assigning 
locations for the functions in the BIOS jump vector. 


4. ROMmable CAPABILITY 


Personal CP/M is ROMmable. The BDOS is linked with the BIOS through 
an absolute code origin (LINK L switch) and data origin (LINK D switch). 
The BDOS has two PUBLIC entry points (CSINIT and WSINIT) that the BIOS 
calls to handle BDOS initialization. CSINIT, the BDOS cold start 
initialization routine, is called from the BIOS cold boot routine. 
WSINIT, the BDOS warm start initialization routine, is called from the 
BIOS warm boot routine. 


5. GLOBAL ACCESS TO USER ZERO SYSTEM FILES 


The BDOS OPEN function opens system files on user zero from other 
user numbers. This makes the USER facility more friendly. Note that the 
BDOS does not allow write operations to user zero files opened in this 
manner. 


6. SUBMIT UTILITY ENHANCEMENTS 


Personal CP/M handles SUBMIT files more efficiently than does CP/M 
2.2. When a file named $$$.SUB is created (by-the BDOS MAKE or RENAME 
functions) on drive A:, the BDOS sets the submit flag. The CCP accesses 
this flag to determine when it should open the $$$.SUB file and begin a 
SUBMIT process. The BDOS also has a 20 byte save area that the CCP uses 
to save the last 20 bytes of the SUBMIT FCB. This eliminates the need to 
open and close the SUBMIT FCB for every command. The XSUB utility has 
also been modified to be consistent with the new submit conventions. The 
BDOS also resets the SUBMIT flag if the $$$.SUB file on drive A: is 
deleted or renamed, thereby terminating the SUBMIT process. The result 
is that, with the exception of those programs that modify the $$$.SUB 
file while a SUBMIT is in process, SUBMIT processing under Personal CP/M 
is functionally equivalent to SUBMIT processing under CP/M 2.2. 
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7. ERROR MESSAGES 


The BDOS error messages are now displayed in the new CP/M-PLUS 
format, ("CP/M Error on d:"), with the errors identified as "Disk 1/0", 
"Invalid Drive", "Read/Only File", or "Read/Only Disk". Note that the 
BDOS error message routine, CPMERR, is assembled independently and linked 
with the BDOS and BIOS modules to build a Personal CP/M system. This 
allows for easy customization of the BDOS error messages to address 
foreign markets. 


8. RETURN ERROR MODE 


The Personal BDOS supports the return error mode of CP/M-PLUS. 
Function 45 is supported. 


9. CONSOLE LOOK-—AHEAD 


The Personal BDOS includes some changes to CONBDOS. ^S support is 
not disabled if the one-character look-ahead buffer contains a character 
other than a ^S. In addition, Function 6 does not ignore the look-ahead 
buffer. 


10. CONSOLE CONTROL 


The Personal BDOS supports Function 109 (Get/Set Console Mode), 
Function 110 (Get/Set Output Delimiter), Function 111 (Print Block to 
Console), and Function 112 (Print Block to List Device). 

Functions 111 and 112 allow a block of characters to be output to 
the console or list device. A parameter control structure consisting of 
two adjacent word values specifies the characters to be output. The 
first word value specifies the address of the first character to be 
output. The second word value specifies the number of characters. 

The Console Mode (bit 4) controls whether escape sequence decoding 
is to be performed in the BIOS for console output. The Console Mode bit 
setting of CP/M-PLUS (0-3, 8, 9) is not supported. Note that enabling 
escape sequence decoding disables tab expansion, printer echo, and ^S 
status checking for BDOS functions 2, 9, and 111. The console Mode 
variable, CONMODE, is a BDOS public which the BIOS CONOUT routine can 
interrogate directly. 

Function 110 specifies the delimiter for Function 9 (Print String). 
The default value for the delimiter is a "$". The delimiter is also set 
to "S" at warm start. 


11. I/O BYTE FUNCTIONS CHANGED 


BDOS Function 7 has been changed to Get Reader Status. It was 
previously Get I/O Byte. BDOS Function 8 has been changed to Get Punch 
Status. It was previously Set I/O Byte. Note, however, that IOBYTE is 
still maintained at location 3 of the base page. These new status 
functions are supported by two new BIOS public routines, RDRSTF and 
PUNSTF. RDRSTF returns 0 in register A if no character is ready for 
input; otherwise, it returns OFFH. PUNSTF returns 0 in register A if the 
punch device is not ready to accept a character for output; otherwise, it 
returns OFFH. 
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12 CALL SCREEN FUNCTION 


The Personal BDOS supports function 113 (Call Screen Function), 
which provides a variety of screen oriented sub-functions such as 
position cursor, clear screen, etc. The BDOS does not support function 
113 directly, but instead passes the call to the BIOS public SCRNF 
routine. The SCRNF function must return zero in register H if these 
functions are not supported in the BIOS. 


13. DRIVE RESET 


The Personal BDOS corrects the CP/M 2.2 Drive Reset (BDOS function 
37) bug that does not allow a program to reset the current disk. The 
redundant BIOS select operations performed in CP/M 2.2 are also 
eliminated. 


14. BOOT PROCESS 


Since Personal CP/M is ROMmable, the BDOS is linked with the BIOS to 
produce an absolute CPM.SYS file. For systems with ROM, control is 
passed to the BIOS cold start entry point when the system is booted. 
Otherwise, a cold boot loader loads the CPM.SYS file from the system 
tracks and passes control to the BIOS cold start routine. The BIOS reads 
the CCP from the system tracks and locates it below the BDOS module at 
system cold or warm start. 
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FUNCTIONAL ELEMERTS 
ENHANCED PERSONAL CP/M BDOS 


- auto disk login 

- no drive reset at warm start 

- blocking/deblocking FLUSH, DISCARD, and MOVE 

- access to user 0 system files for all users 

- improved SUBMIT performance 

- BDOS error messages in separate file 

- extended error handling (physical error support) 

- block character I/O to console and list device 

- communications channel input, output, and status 

- screen functions with byte BLT (Block Level Transfer) 


ADAPTABLE CONSOLE COMMAND PROCESSOR 


- CCP loaded separately by BIOS 

- source provided for standard CP/M 2.2 style CCP 

- Personal CCP (VCCP) source provided for standard "Personal 
CP/M" user interface 


